Skip to content

Conversation

@nicohrubec
Copy link
Member

@nicohrubec nicohrubec commented Jan 16, 2026

This PR adds automatic instrumentation for global request and function middleware in TanStack Start applications.

Overview

The sentryTanstackStart Vite plugin now automatically wraps requestMiddleware and functionMiddleware arrays in createStart() with Sentry instrumentation. This is done via a source code transformation during the build that converts:

createStart({
  requestMiddleware: [myMiddleware],
  functionMiddleware: [anotherMiddleware],
});

into:

import { wrapMiddlewaresWithSentry } from '@sentry/tanstackstart-react';

createStart({
  requestMiddleware: wrapMiddlewaresWithSentry({ myMiddleware }),
  functionMiddleware: wrapMiddlewaresWithSentry({ anotherMiddleware }),
});

Usage

Auto-instrumentation is enabled by default. To explicitly disable it:

// vite.config.ts
import { sentryTanstackStart } from '@sentry/tanstackstart-react';

export default defineConfig({
  plugins: [
    sentryTanstackStart({
      org: 'your-org',
      project: 'your-project',
      autoInstrumentMiddleware: false, // Disable auto-instrumentation
    }),
  ],
});

This should give users flexibility in case things go wrong.

Implementation Details

  • Uses a regex-based approach to transform source files containing createStart()
  • Skips transformation if the user has already manually wrapped middlewares with wrapMiddlewaresWithSentry
  • Only handles simple identifier arrays (e.g., [foo, bar]), not complex expressions

Testing

  • Updated E2E tests to use auto-instrumentation for global middleware
  • Updated unit tests for the sentryTanstackStart plugin
  • Added unit tests for autoInstrumentMiddleware

Follow-ups

Future PRs will add support for non-global request/function middleware. This PR focuses on global middleware to make it a bit easier to review. I also want to give users a bit more control by allowing them to disable auto-instrumentation on a file-level, but this doesn't make sense yet since the current implementation only patches a single file anyways.

Closes #18845

@nicohrubec nicohrubec self-assigned this Jan 16, 2026
@nicohrubec nicohrubec marked this pull request as ready for review January 16, 2026 10:00
Copy link

@cursor cursor bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cursor Bugbot has reviewed your changes and found 1 potential issue.

Bugbot Autofix is OFF. To automatically fix reported issues with Cloud Agents, enable Autofix in the Cursor dashboard.

@nicohrubec nicohrubec force-pushed the nh/automatic-middleware-instrumentation branch from 50e7961 to 2706bc0 Compare January 16, 2026 15:33
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Auto-instrument global request/function middleware

2 participants